Metadata API resources | eBay Developers Program

Skip to main content

API License Agreement Update: We have made significant enhancements to our API License Agreement, including detailed data protection measures and compliance with international regulations. Important restrictions have been applied to the use of Restricted APIs and AI content. Developers must review the updated agreement to ensure compliance.
Important Update: eBay's API integrations will be modified to address data handling requirements for select developers. Usernames will be replaced with immutable user IDs, and financial data will be protected for certain users. Learn more here.

The Metadata API has operations that retrieve configuration details pertaining to the different eBay marketplaces. In addition to marketplace information, the API also has operations that get information that helps sellers list items on eBay.

marketplace

Method Name	HTTP Method	Path	Summary	Samples
getAutomotivePartsCompatibilityPolicies	GET	/marketplace/{marketplace_id}/get_automotive_parts_compatibility_policies	Retrieves metadata on all eBay categories that support Parts Compatibility for a given eBay marketplace.	View getAutomotivePartsCompatibilityPolicies - /marketplace/{marketplace_id}/get_automotive_parts_compatibility_policies
getCategoryPolicies	GET	/marketplace/{marketplace_id}/get_category_policies	Retrieves eBay category policy metadata for a specified marketplace.	View getCategoryPolicies - /marketplace/{marketplace_id}/get_category_policies
getClassifiedAdPolicies	GET	/marketplace/{marketplace_id}/get_classified_ad_policies	Retrieves eBay classified ad policy metadata for a specified marketplace.	View getClassifiedAdPolicies - /marketplace/{marketplace_id}/get_classified_ad_policies
getCurrencies	GET	/marketplace/{marketplace_id}/get_currencies	Retrieves eBay default currency for a specified marketplace.	View getCurrencies - /marketplace/{marketplace_id}/get_currencies
getExtendedProducerResponsibilityPolicies	GET	/marketplace/{marketplace_id}/get_extended_producer_responsibility_policies	Retrieves all eBay categories that support/require Extended Producer Responsibility data for a given eBay marketplace.	View getExtendedProducerResponsibilityPolicies - /marketplace/{marketplace_id}/get_extended_producer_responsibility_policies
getHazardousMaterialsLabels	GET	/marketplace/{marketplace_id}/get_hazardous_materials_labels	Retrieves available hazardous materials label information for a given eBay marketplace.	View getHazardousMaterialsLabels - /marketplace/{marketplace_id}/get_hazardous_materials_labels
getItemConditionPolicies	GET	/marketplace/{marketplace_id}/get_item_condition_policies	Retrieves item condition metadata for one, multiple, or all eBay leaf categories for a given eBay marketplace.	View getItemConditionPolicies - /marketplace/{marketplace_id}/get_item_condition_policies
getListingStructurePolicies	GET	/marketplace/{marketplace_id}/get_listing_structure_policies	Retrieves all eBay categories that support multiple-variation listings for a given eBay marketplace.	View getListingStructurePolicies - /marketplace/{marketplace_id}/get_listing_structure_policies
getListingTypePolicies	GET	/marketplace/{marketplace_id}/get_listing_type_policies	Retrieves eBay listing type policy metadata for a specified marketplace.	View getListingTypePolicies - /marketplace/{marketplace_id}/get_listing_type_policies
getMotorsListingPolicies	GET	/marketplace/{marketplace_id}/get_motors_listing_policies	Retrieves eBay Motors policy metadata for a specified marketplace.	View getMotorsListingPolicies - /marketplace/{marketplace_id}/get_motors_listing_policies
getNegotiatedPricePolicies	GET	/marketplace/{marketplace_id}/get_negotiated_price_policies	Retrieves metadata on all eBay categories that support Best Offer feature for a given eBay marketplace.	View getNegotiatedPricePolicies - /marketplace/{marketplace_id}/get_negotiated_price_policies
getProductSafetyLabels	GET	/marketplace/{marketplace_id}/get_product_safety_labels	Retrieves available product safety label information for a given eBay marketplace.	View getProductSafetyLabels - /marketplace/{marketplace_id}/get_product_safety_labels
getRegulatoryPolicies	GET	/marketplace/{marketplace_id}/get_regulatory_policies	Retrieves all eBay categories that support/require regulatory policies data for a given eBay marketplace.	View getRegulatoryPolicies - /marketplace/{marketplace_id}/get_regulatory_policies
getReturnPolicies	GET	/marketplace/{marketplace_id}/get_return_policies	Retrieves return policy metadata for one, multiple, or all eBay leaf categories for a given eBay marketplace.	View getReturnPolicies - /marketplace/{marketplace_id}/get_return_policies
getShippingPolicies	GET	/marketplace/{marketplace_id}/get_shipping_policies	Retrieves eBay shipping policy metadata for a specified marketplace.	View getShippingPolicies - /marketplace/{marketplace_id}/get_shipping_policies
getSiteVisibilityPolicies	GET	/marketplace/{marketplace_id}/get_site_visibility_policies	Retrieves eBay international site visibility policy metadata for a specified marketplace.	View getSiteVisibilityPolicies - /marketplace/{marketplace_id}/get_site_visibility_policies

compatibilities

Method Name	HTTP Method	Path	Summary	Samples
getCompatibilitiesBySpecification	POST	/compatibilities/get_compatibilities_by_specification	Retrieves all compatible applications for a part based on the provided specifications.	View getCompatibilitiesBySpecification - /compatibilities/get_compatibilities_by_specification
getCompatibilityPropertyNames	POST	/compatibilities/get_compatibility_property_names	Retrieves product compatibility property names for a specified category.	View getCompatibilityPropertyNames - /compatibilities/get_compatibility_property_names
getCompatibilityPropertyValues	POST	/compatibilities/get_compatibility_property_values	Retrieves product compatibility property values associated with a single property name, in the specified category.	View getCompatibilityPropertyValues - /compatibilities/get_compatibility_property_values
getMultiCompatibilityPropertyValues	POST	/compatibilities/get_multi_compatibility_property_values	Retrieves product compatibility property values associated with the specified property names, in the specified category.	View getMultiCompatibilityPropertyValues - /compatibilities/get_multi_compatibility_property_values
getProductCompatibilities	POST	/compatibilities/get_product_compatibilities	Retrieves all available item compatibility details for the specified product.	View getProductCompatibilities - /compatibilities/get_product_compatibilities

country

Method Name	HTTP Method	Path	Summary	Samples
getSalesTaxJurisdictions	GET	/country/{countryCode}/sales_tax_jurisdiction	Retrieves sales tax jurisdictions for countries that support tax tables.	View getSalesTaxJurisdictions - /country/{countryCode}/sales_tax_jurisdiction